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INTRODUCTION 


- Welcome to ZEUS, the assembler based machine code operating system for 
the ZX Spectrum. 


ZEUS provides the optimum method for writing Z80 machine code on your 
computer and yet, as you will shortly discover, it is even easier to use than BASIC! 


The heart of ZEUS is a high speed two-pass assembler designed to allow the 
convenient symbolic representation of your machine. code program: lines of 
assembly language mnemonics (machine code instructions) are entered as simply as 
you would enter a BASIC program. But here the similarity with other assemblers 
ends, for the true power of ZEUS stems from the unique versatility of its operating 
system. Just as the Sinclair ROM enables you to write BASIC, so ZEUS provides all 


the facilities you need to produce machine code programs quickly and efficiently. 


The following terms are used throughout the rest of this manual and their 
definitions are provided here for those unfamiliar with assembler terminology. 


SOURCE FILE: The text, including all assembly language mnemonics, labels 
and comments is collectively known as the source file. 


OBJECT CODE: The object code is the machine code produced by ZEUS from 
the source file. 


SYMBOL: A symbol is a string of alphanumeric characters used to represent 
a numerical value (either data or an address). 
A label is a special type of symbol the value of which corresponds 
to the address of the instruction which immediately follows it. 


DIRECTIVE: An assembler directive is not an actual Z80 instruction but 
represents an order given by the programmer to the assembler 
which results in the storing of values either into symbols or 
into memory. 


SECTION 1 


LOADING AND RUNNING ZEUS 


If you wish to use the ZX printer with ZEUS then remember to connect it up 
before plugging in your Spectrum. 


1. Rewind the cassette to the beginning of either side. 


2. Set the volume on your recorder to about % maximum and the tone to full 
treble. 


3. Connect the EAR socket on your recorder to the EAR socket at the rear of 
the computer. 


4. Type LOAD “zeus” or simply LOAD º ®. Press ENTER and start the tape. 


5. ZEUS will auto-run on loading, displaying the copyright message and flashing 
cursor. 





SECTION 2 


WRITING MACHINE CODE WITH ZEUS 


This section is a description of the entry of a short machine code subroutine 


which, along with the program itself, has been written to illustrite some of the 
features of ZEUS. 


The program loads byte 255 into each address (memory location) on the 


screen. The screen is 6144 bytes in length and starts at address 16384. The outline 
of the program along with its BASIC equivalent is as follows: 


loop 


LD HL, 16384 
LD DE,16385 


LD A,255 
LD (HL),A 
LD BC,6143 
LD A,(HL) 
LD (DE),A 
INC HL 
INC DE 
DEC BC 
LD A,B 
ORC 

JR NZ, loop 
RET 


5090 LET HL=16384 
5010 LET DE=16385 

5920 LET A=255 

5030 POKE HL,A 

5040 LET BC=6143 

5950 LET A=PEEK HL 
5ØØPOKE DE,A 

5970 LET HL=HL+1 

5080 LET DE=DE+1 

5999 LET BC=BC-1 

5199 IF BC <> Ø THEN GOTO 5050 
5119 RETURN 


Firstly, clear the screen by pressing CAPSHIFTED ‘9’ (equivalent to entering 
‘graphics’ mode in Sinclair BASIC). 


Entering lines of text is very similar to writing a BASIC program. Each line 
must be prefixed by a number which may take any value from @ to 65534 inclusive. 
It is important to remember that, providing the line the cursor is on begins with a 
valid line number, pressing ENTER will insert that line at the correct position in 
the source file so replacing any previously existing line which had the same number. 


The command to tell ZEUS to provide line numbers automatically is of 
the form: 
Ixy 
where x = line number from which to start 
y = increment between successive line numbers 
x and y are called ‘parameters’ because they specify the particular values which the 
command will use when it executes. For example, in a long BASIC program you 
may use 
LIST 1000 
Here, the parameter 1®®® causes the command to commence listing from line 


1 900. 


To illustrate the use of parameters type: 
1199190 
i i -li ber mode simply 
and press ENTER several times. To exit from auto-line num = 
delete the current line number (eg. with CLEARLINE: CAPSHIFTED ‘1’) and 
press ENTER. 


Clear the screen (CAPSHIFTED ‘9’), type ‘I’ and press ENTER several 
times. As you have not specified particular values for the parameters x and y, 
ZEUS has used the ‘default’ values which are x=19 and y=1f. To take an example 
from BASIC, the default value of the LIST command parameter is the first line 


number. 


To enter the first few lines of text: 
1. Clear the screen (CAPSHIFTED 9’) 
2. Type ‘I’ followed by ENTER (once only) 
3. Type in the following lines of text, pressing ENTER after 
each to insert the line in the source file andto produce the 
next line number: 


LD HL,16384 
LD DE,16385 
LD A,255 
LD (HL), A 
LD BC,6143 


If you enter a character incorrectly use ERASE 
(CAPSHIFTED ‘9”) and re-type. 

4. Exit from auto-line number mode (CAPSHIFTED ‘1° 
followed by ENTER). 


You may now use the full screen editor which, as the name suggests allows 
the text to be edited by altering it as it is displayed on the screen. 


Firstly it is necessary to obtain a listing of the source file. Clear the screen 
and enter ‘L’ (short for LIST). The LIST command takes up to three parameters 


of the form: | A (not L x yz) 


where x = line number to list from 
y = line number to list up to 
z = number of lines to list before pausing 


To alter a particular character in the text use the cursor control keys 
(CAPSHIFTED ‘5’, 6, ‘P & ‘8°) to move the cursor to the desired point in the 
listing and simply type in the replacement character. The cursor will move auto- 
matically to the next character position. Remember that the modified line will only 
be inserted into the text on pressing ENTER when the cursor is sitting on that line. 


For example, to change line 39 to read: 

99030 LD A,254 
firstly obtain a listing of the text and using the cursor control keys place the 
cursor in the same character square as the right hand ‘5’ digit. Type ‘4’ and press 
ENTER. CLEARSCREEN and LIST. You may now change the number back to 
255 either by the same method or by entering 

39 LD A,255 
Before proceeding, CLEARSCREEN and LIST. 


m: 


The next part of the program involves a loop. It is often desirable to indent 
‚ps in order to make a program more readable. To speed the process of entering 
tions of indented text, ZEUS provides a ‘user definable’ TAB facility. The TAB 
‚ps may be set up from within the Monitor. Type ‘M’ and press ENTER. The 
rd ‘Monitor’ appears to remind you of the mode you are in. Next type ‘S’ and 
‚ve the cursor along until it is lined up with the column of ‘L’s in the listing at 
: top of the screen. Now type a non space character (eg. ‘1°) followed by, say, 
spaces, a further ‘1’ and ENTER. CAPSHIFTED ‘2’ will now move the cursor 


the stops you have just defined. 


Return to ZEUS (enter ‘Z’). Now you are ready to add the loop. Firstly enter 
60” to invoke auto-line numbering from line 69. Type in the word ‘loop’ (which 
u may wish to put in lower case characters by using the CAPSHIFT key). Use 
\PSHIFTED ‘2’ to put the cursor at the next TAB stop. Now type: 


LD A,(HL) 
d press ENTER. Enter the following lines remembering to indent by using 


\PSHIFTED ‘2°: 
LD (DE),A 


INC HL 
INC DE 
DEC BC” 
LD A,B 
ORC 

JR NZ,loop 


Note that each reference to a particular label must be identical, character 
r character, to that label. Hence if you have used lower case in line 69 then you 


ust do the same in line 139. 


Enter the last line without the indent, ie.: 


00140 RET 


Exit from auto-line number mode (CAPSHIFTED ‘1’ followed by ENTER). 


Two additional lines are necessary before you can assemble and test the 
routine. Firstly, you must tell ZEUS where to pl i 
; place the assembled code b 
the directive ORG. oe 
Enter 5 ORG 30000 


to assemble the machine code from memory location 30999. 


Secondly you must set an entry point, ie. the point from which the execute 
command (‘X’) will run the code. Enter: 


6 ENT 
followed by CLEARSCREEN and LIST. 


You will notice that it is necessary to press ENTER twice to list the complete 
source file. This is because the default value for the z parameter (number of lines 


to list before pausing) is 14 and the source listing is now 16 lines long. 


ZEUS also features a renumber command of the form: 
Rxyz 
See ZEUS Assembler commands (Section 4) for definition of the parameters. 
To renumber the source file, enter ‘R’. Now list the first 5 lines by typing: 
BS 
and pressing ENTER once only. Note that the use of a comma to replace a a 
ameter causes the command to use the default value of that parameter. You can see 


that the source has been renumbered in accordance with the default values of the 
R’ command. 


Check carefully that the source file is identical to the following: 


99919 ORG 39999 
00020 ENT 

90930 LD HL,16384 
99049 LD DE,16385 
00050 LD A,255 
90969 LD (HL),A 
00070 LD BC,6143 
00080 loop LD A, (HL) 
00090 LD (DE) ,A 
99199  INCHL 
99119 .. INC DE 
00120 DEC BC 
99130 + LDAB 


00140 ORC 
00150 JR NZ, loop 
09169 RET 


Now you are ready to assemble the source file to produce the object code, 
ommonly called the machine code. Type ‘A’ (short for ‘assemble’) and press 
NTER. 


If all is well the cursor will simply move below the ‘A’. If you have made a 


\istake. an error report will have been issued followed by the offending line. If 
he error is not apparent, consult the appendix on error report codes. 


At this stage the easiest mistake to make is to omit a space from within an 
nstruction. This will produce error ® (incomplete statement). You may find it 
vorthwhile to purposely introduce an error by, for example, removing the apace E 
ine 30. (CLEARSCREEN, LIST, place the cursor in the space between ‘D’ an 
H’, DELETE (CAPSHIFTED ‘3’), ENTER, CLEARSCREEN, ASSEMBLE). 


You should see: 


Error À 
00030 LDHL,16384 


To correct the error, move the cursor to the ‘H’ and use INSER] 


(CAPSHIFTED ‘4’) to add the space, ASSEMBLE, CLEARSCREEN and 
LIST. 


It is advisable to save the source file on tape prior to execution. 
Loading and saving is accomplished by using the BASIC commands and 
treating the source file as a block of data bytes. 


The BASIC command to save a block of bytes is of the form: 
SAVE “filename” CODE x,y 

where x = address of the first data byte 
y =length of data 


The values of the parameters x and y are given by the ‘T’ command. 
Enter ‘T’ and you should see .. 


Start of source = 32768 
00144 


length 


Return to BASIC by entering ‘Q’ (short for QUIT) and use 
SAVE “source 1” CODE 32768,144 
to save the source to tape. Check your recording with 


VERIFY ° º CODE 


To return to ZEUS enter 
PRINT USR 57344 


Before you can list the source you must enter ‘O’ to tell ZEUS to 
ve the old source file. The ‘O°’ command can also take a parameter, 
being the start address of the file it is to retrieve. 


You may create a source file at a different address by either: 


i) Using the ‘N’ (short for NEW) command before you enter the 
program. The parameter specifies the address from which the 
source will be built, or ‘ e 


ii) Reloading an old source file to a different location to that from 
which it was saved (see Section 4, ‘T’ Command). 


When you commenced entering lines of text, ZEUS automatically 
ted the source from the default value of the ‘N’ command, ie. address 


68 (or 8000 hex.). 


If you have a ZX printer attached then you may make a ‘hard copy’ 
he source file. To turn the printer ‘on’, enter ‘P1’. Now enter 
1.:5:16 


When the printer is ‘on’ all output sent to the VDU. is also sent to 
printer. To turn the printer ‘off’ enter ‘PQ’. You may interrupt the 
iter by using the BASIC BREAK key. Return to ZEUS in the normal 


You are now ready to test the routine. Enter ‘X’ (short for EXECUTE). 
ll well the screen (apart from the border) will fill with the current ink 
‚ur (ie. white). If this does not happen, list the source and check it 
fully against the listing above. If the computer ‘crashes’ simply reload 
US, QUIT and load the source file using LOAD ° ° CODE. Remember 
ise the ‘O’ command to retrieve the old source file. 


In this section you will have gained an appreciation of the way ZEUS 

be used to produce a simple subroutine. Yet there are many additional 
tures at your disposal to aid the programming of more complex routines. 
> next section provides a comprehensive description of these and also 
ısolidates the features already mentioned. 


SECTION 3 


ENTERING AND EDITING TEXT 
3.1 General format 


ZEUS uses the ASCII character set. To enter assembly language 
instructions you must firstly type in a line number and follow it with the 
required line of text. The line number must lie in the range ® — 65534 
inclusive. 


The text must consist of one or more statements seperated by colons. 
Each statement comprises: 


a) An optional label 
b) An instruction 


c) An optional comment 
a) Optional label 
-The following rules govern the use of labels: 


i) A label may contain upper and lower case letters and digits, 
ii) A label must start with a letter, 
iii) Labels can be up to 14 characters in length, 


iv) A label must not be identical to a reserved word (eg. using ‘LD’ 
as a label is not permitted). However, a label may contain re- 
served words (eg. ‘HELD’ would be valid). Fora list of reserved 
words see appendix three. 


v) A label must be seperated from an instruction by a space. 


Note that every reference to a particular label must be identical 
character for character, to that label. 
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Instruction. 


An instruction may be any of the standard Zilog Z80 instructions or 
ay be an assembler directive (see below). An extra facility is provided 
7EUS for referring to the parity/overflow flag. When using ZEUS you 

refer to “jump overflow” instead of ‘jump parity even”. Thus: 


JIPPE, ovit may be written IPV ee 
JP PO, cms may be written JP NV, she 


two versions are completely interchangeable but their use can help to 
e a routine more readily comprehensible. 


Optional comment 


A comment may be appended to the end of any instruction. It must 
seperated from the instruction by a semi-colon. Lines containing just 


iments are also allowed. 


Constants 


Constants may be expressed either in decimal or hexadecimal form as 
Ows: 
Decimal: 1 99 234 4096 
Hexadecimal: #A #FE #6843 #5C00 


erals can be expressed as follows: 
eA 7 9 TE oO 


r example, to load the literal ‘C into the accumulator, use: 


LD A, °C 


A 


Note that in Z80 convention, parentheses denote an address. 
eg. LD A, (200) will load the accumulator with the contents of memory 
location 200 (decimal). 


Finally, there is also a system constant ‘$’ which is set to the current 
assembly address. i! 


eg. 
DJNZ $ is equivalent to loop DJNZ loop 


3.3 Operators 


In order to further facilitate the writing of symbolic programs, ZEUS 
allows the use of logical operators. 


The operators provided are: 


+ addition 

— subtraction 
& logical AND 
! logical OR 


No operator priority is observed; expressions are evaluated strictly 
from left to right. 


3.4 Expressions 


Wherever a constant is required in an instruction an.expression may be 
used in its place. Expressions are built from labels and/or constants 
seperated by operators. 
eg. LD A, (ADDRESS+offset) 

LD HL,START-3 
IN A, (PORT & #FF) 
LABEL !#FFQQ 


Note that expressions will be computed by the assembler to determine 
actual memory location which will be inserted into the object code. 
pressions are computed at assembly time, not at program execution 


le. 


5 Assembler Directives 


g 


The following ‘pseudo-operations’ either provide parameters for the 
eration of ZEUS or instruct the assembler to store values either as 
mbols or directly into memory: 


LG nnnn 


SP nnnn 


Short for ORIGIN. This directive instructs ZEUS to 
assemble the block of machine code (as translated 
from the source listing after the ORG statement) from 
address nnnn (provided that the current DISP value is 
zero — see below). 

Multiple ORGs within the same source file are allowed. 
Each ORG statement will redirect the address from 
which subsequent code is assembled. 


Short for DISPLACEMENT. A DISP instruction alters 
the place from which subsequent code is generated 
even though the code so produced is assembled to run 
at the address specified by the current ORG parameter. 
It is sometimes convenient to be able to generate code 
at a different location from the one at which it is 
ultimately intended to run (for example if the latter is 
occupied at present). The monitor may be used to 
relocate the code to the ORG address. 


For example, given the following two statements at the 
start of a source file:. 


ORG 30000 
DISP 19909 


the source following would be assembled from 40000 
but would only normally run at 30000. 


—_— wee 


add 


Thun 


aS 
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ENT Set an entry point. The ‘X’ command executes the 
assembled code from the last ENT directive in the 
source file. 


EQU Short for EQUATE or EQUALS. A label (symbol) may 
have a value assigned to it using a statement of the 
form: 

label EQU value 


DEFS nnnn inserts nnnn spaces at the current assembley address 


DEFB nn,nn,.. inserts bytes nn at the current assembly address. 


„inserts words (addresses) nnnn at the current assembly 
address. 


DEFW nnnn,nnnn, 


The text enclosed in the ‘/’ delimiters will be inserted 
at the current assembly address. 


DEFM/string/ 


As with all assembly language instructions, directives may be prefixed 
by a label. 


eg. - DATA! DEFW 40000,3456,6789 


OFFSETS DEFB 3,2,14 a 9,2 
USRADDR ENT 


3.6 Screen Editor 


ZEUS provides a full screen editor to facilitate modification of the 
source file. 


Firstly list the text by using the ‘L’ command. The cursor may now be 
moved to any point in the listing by using the cursor control keys 


-(CAPSHIFTED ‘5’, ‘6°, ‘7’, *8°) 


To replace the character at the current cursor position simply enter 
the new character. The cursor will move automatically to the next 
character position. 


Space may be inserted into a line at the current cursor position by 
using the inverse video key (CAPSHIFTED ‘4’). The character at the edge 
of the screen is lost. 
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The character at the cursor positi à 
position may be del 
deo key (CAPSHIFTED 3°). y pe geleted by using tie sue 


Having altered the line i ill i 
, pressing ENTER will insert th ine i 
‚rrect place in the text. oat 


Other commands are: E 


LEARSCREEN: The entire screen may be cleared and the cursor placed 


at the top left hand corner by usin é th 
g the h k 
(CAPSHIFTED ‘9’). graphics key 


LEARLINE: a pees line may be cleared and the cursor 
placed at the start of the line usin ‘edit’ 
g the ‘edit’ k 
(CAPSHIFTED ‘1’) ; = 
NB. This command does not remove the current line from 
the text but simply from the screen. 


AB: The ‘Caps lock’ key (CAPSHIFTED ‘2’) moves the 
cursor to the next tab stop on the current line. The 


tao stops may be set up from within the Monitor 
(See Section 5). 


Dev saves 1 


ZEUS ASSEMBLER COMMANDS 


A command consists of a command letter followed by any number of 
numerical or string parameters. 


Numerical parameters consist of either a decimal or a hexadecimal 
constant. Entry of numerical parameters overwrites the default parameters 
for that command. 


If it is desired to alter a later default parameter without upsetting 
earlier ones, this can be achieved by entering a comma for every parameter 
to be skipped. 
eg. L List the text from start to finish 

L1®5® List the text from line 19 to line 50 
L ,5® List the text from the start to line 50 


String parameters are represented by enclosing the string within 
delimiters. Delimiters can be any character except ‘, or ‘# or any digit. 


eg. 
E “LDIR” finds all occurences of the string LDIR 


F /LDIR/ ditto 

Commands 

Ax Assemble the source file and display error messages. 
After x errors have been encountered and displayed, 
assembly will stop. To continue assembly, press 
ENTER. DEFAULT: x = 14 

Dxy Delete all lines between line x and line y inclusively. 
If no parameters are given, no action will be taken. 

F “string” x y Z This command searches the source file for all 


occurences of the given string. The search commences 
at line x and finishes at line y. Any lines containing the 
string are displayed and a pause initiated after z lines 
have been displayed. 

DEFAULT: x = lowest line number y = highest line 


— 69 69 


number z = 14 “‘string” = 


xyz 


After entry of this command, ZEUS will automatically 
generate line numbers, starting with line number x. 
Any text entered will be inserted in the correct place 
in the source file and another line number generated. 
Parameter y is the spacing between successive line 
numbers. Deleting the line number and pressing 
ENTER will halt auto line numbering. 
DEFAULT: x= 19 y= 19 j 


List the source file from line x to line y. Parameter z 
gives the number of lines to be listed before pausing. 
DEFAULT: x = start y = finish z = 14 


Enter the Monitor (See Section 5). 


Create a new, empty source file at address x. NB. care 
must be taken when using this command as placing a 
source file at certain locations may cause a crash. 
DEFAULT: x = 32768 (#8000) 


This command causes the ‘old’ source file at address x 
to become the current source; it is usually used to 
retrieve a source file which has been loaded to address x. 


DEFAULT: x = 32768 (#8000) 


Printer operation. x = 1 turns the printer on. All 
output to VDU. is also sent to the ZX printer. Pressing 
BREAK during printer operation causes a return to 
BASIC. Re-enter ZEUS as normal (the printer is 
automatically switched off on re-entry). x = @ turns 
the printer off. 

DEFAULT: x = 


QUIT. Exit to BASIC. To return to ZEUS, enter 
PRINT USR 57344 


Rxyz 


Sx 


Renumber the source file. The parameters are as follows: 
x : the first new line number 

y : the spacing between successive new line numbers 

z : the line to start re-numbering from. 


DEFAULT: x = 19 y= 19 z = lowest current line 
number 


Print the symbol table. x gives the number of symbols/ 
labels and their associated hexadecimal values listed 


before pausing. 
DEFAULT: x = 15 


Display the start address and length of the current text 
file in bytes. The file may be saved by returning to 
BASIC (‘Q’) and using: 
SAVE “filename” CODE start, length 
To reload an old source file to 
i) the same address as it was saved from, use: 
LOAD “filename” CODE 
ii) a different address, use: 
LOAD “filename”, start address 


Having loaded an old source file, re-enter ZEUS 
(PRINT USR 57344) and enter the command 


O start address 


to retrieve the source file starting at ‘start address’ 


Execute the machine code produced by the last 
assembly. Execution begins at the ENT statement 
nearest to the end of the source file. 

If no ENT statement existed, an error message is 
issued and no execution occurs. 


-CTION 5 


HE MONITOR 


The co-resident Monitor allows you to directly inspect and manipulate 
emory and the I/O ports and also set up several options within ZEUS. 


ONITOR COMMANDS 


xyz 


This command displays both the decimaland the hexadecimal 
representation of the value x which may be of either form. 
eg. 

A 59 prints HEX =#3B DECIMAL = 59 


A#2A prints HEX =#2A DECIMAL = 42 


Copy a block of memory. This command takes three 
parameters, as follows: i 


x : start address of block to be copied from 
y : start address of block to be copied to 
z : the number of bytes to copy. 


Execute machine code from address x. 
Print the value of I/O port x. 


This command allows the border, paper and ink colours to 


be altered. x is the byte which is used to fill the attributes 
table, it is made up of four fields: 


Bits Ø — 2 control the ink colour 
Bits 3 — 5 control the paper colour 
Bit 6 is set for ‘bright’ 

Bit 7 is set for ‘flash’ 


y is the required border colour 


eg. KF 1 : white ink on blue background with blue border 
K 38 7 : black ink on white background with white 
border.. 


Notes: 


Enter modify mode starting at address x. 

The modify command provides an extremely flexible and 
hence powerful memory manipulation tool. 
For example, 


M 6990 


will print: 


6999 XX (note the position of the cursor) 


XX is the present contents of address 6000. You may now 
proceed in four ways: 


a) 


b) 


c) 


d) 


ii) 


Alter the contents of the address 

Type the new value over the old one and press ENTER. 
Modify prints the next address, 6901, along with its 
present contents. 

Alter the contents of the address and subsequent 
addresses simultaneously. 

Type the new value for the present address followed 
by the values to be written in the subsequent addresses. 
On pressing ENTER, modify will print the address and 
value of the byte after the last one modified. 

Alter the modification address 

Type ‘/’ followed by the new address. On pressing 
ENTER, modify will move to the new address. 

Exit from modify mode 

Type a full stop and press ENTER. 


Characters can be entered by the use of quotes. 
eg. after entering M 6000 overwrite the present value 
with °C. The ASCII value of the character ‘C “is 
now at address 6000. 
More complex formats can be entered. For example: 
6000 43 4149 °A °C PD. 
enters the six values into 6099 to 6095 and leaves 
modify mode. 
6990 43 41 49 / 6500 83 81 80 
enters bytes 43 41 40 into 6999 to 6002. It then 
moves the modify address to 6509 and enters 83 81 
and 80 into addresses 6509 to 6502. Finally it prints 
6593 followed by the contents of that address. 
The above sequences can be combined with the ‘enter 
modify mode’ command (‘M’) 
eg. 
M 6000 FF 42. 
enters modify mode, puts FF into 6000 and 42 into 
6001 and leaves modify mode. 


APPENDIX I 


Oxy Output the value y to I/O port X Commence It 
S Set TAB stops. Any non space character on the same line i) iia empembler 
as the ‘S’ will define a TAB stop (provided the line is Ax ASSEMBLE. Print x errors at a time. 
entered). CAPSHIFTED ‘2’ advances the cursor between Dxy DELETE from line x to line y inclusive. 
the stops. 5 F“string”xyz FIND ‘string’ between line x and line y; print 
eB. l z occurences at a time. i 
S Í | Ixy INSERT (auto line number) starting at line x with 
sets TAB stops at the columns occupied by the ‘1’ character. increments of y. 
Lxyz LIST from line x to line y in steps of z lines. 
M Enter MONITOR. 
Try Tabulate memory from address x. The contents of memory Nx Create a NEW source file at address x. 
are displayed eight bytes at a time in hexadecimal form. Ox Recover OLD source file at address x. 
Each line is prefixed by the address of the first byte on that Px PRINTER control: x = 9 for ‘off’; x = 1 for ‘on’. 
line. After y lines have been displayed, tabulation will halt. Q QUIT. Return to BASIC. l 
To continue, press ENTER; any other key will return you Rxyz RENUMBER the source file from line z to commence with 
to normal (command) mode. line x and increments of y. 
Sx Print the SYMBOL TABLE x lines at a time. 
Note that is is possible to modify memory by the following T Display the start address and length of the source file. 
method: tabulate the required area of memory as described X EXECUTE object code at last ENT statement 


above and after returning to command mode, enter modify 
mode (‘M’). Using the cursor control keys, move the cursor 
up into the tabulated listing. After altering all the required 
values on a given line press ENTER to modify the actual 


AX Print x in decimal and hex. 
memory locations. Cxyz COPY a block of memory from address x to address y for a 
. ; length z bytes. 
Exit from modify mode as before by typing a full stop and Ea EXECUTE a machine code routine from address x. 
pressing ENTER. Ix Print the value of I/O port x. l 
Kxy Set up the paper, ink and border colours. 
Z Return control to the assembler Mx Enter MODIFY mode at address x. 
f i Oxy OUTPUT byte y to I/O port x. 
Note that all constants entered in the Monitor must be hexadecimal (with S SET up the TAB stops. 
the exception of the ‘A’ command which, like the assembler defaults to Txy TABULATE memory from address x, y lines at a time. 


jecimal; prefix hex values with a ‘#’ symbol) Z Return to the assembler. 


ii) Screen Editor 


CAPSHIFTED ‘1’ (‘edit’) 
CAPSHIFTED ‘2’ (‘Caps lock’) 
CAPSHIFTED ‘3’ (‘True video’) 
CAPSHIFTED ‘4’ (‘Inv. video’) 


CAPSHIFTED ‘5’, ‘6°, ‘7’ & ‘8’ are the cursor directional control keys 
‘graphics’) Clear the screen and home the cursor 


CAPSHIFTED ‘9 ( 


APPENDIX TWO 


Error Report Codes 


NUMBER 


position. 


MEANING 


Ilegal character or incomplete statement 


Label too long 

‘Y symbol expected 

Truncation error or jump out of range 
‘” expected 

Context error 

Redefined label 

‘( symbol expected 

Illegal mnemonic 

Undefined label 


Clear the line containing the cursor 
Move the cursor to the next TAB stop 
Delete the character under the cursor 
Insert a space character at the cursor 


APPENDIX THREE 


Reserved Words 


The following is a list of reserved words, ie. those which must not be used 
as labels, although any label may contain them. 


A ADC ADD AF’ 
C CALL CCF CP 
D DAA DE DEC 
DISP DJNZ E EI 
HALT HL I IM 
INIR IX IY JP 
LDI LDIR M NC 


RLCA RLD RR RRA 
SCF SET SLA SP 

Z 

APPENDIX FOUR 


Zeus memory map 


The following areas of memory are 


A) 


B) 


C) 


D) 


ZEUS machine code 


and workspace 
Source file 
Assembled Code 
(Object code) 


Symbol Table 


AF AND B BC BIT 
CPD CPDR CPI CPIR CPL 
DEFB DEFM DEFS DEFW DI 
ENT EQU EX EXX H 
IN INC IND INDR INI 


JR L LD LDD LDDR 
NEG NOP NV NZ OR 
OUTD OUTI P PE PO 


RETI RETN RL RLA RLC 
RRC RRCA RRD RST SBC 
SRA SRL SUB V XOR 


used by ZEUS: 


57344 — 65279 (#EQ00 — #FFØ0) 


Initially starts at 32768 (#8000) but 
may be altered with the ‘N’ command. 


Defined by the user through the 
directives ORG & DISP 


This is ‘the table which contains the 
alphanumeric symbols and labels defined 
in the source file along with their 
associated values. It starts at 57343 and 
increases in size downwards at a rate of 
sixteen bytes per label used. 


Note: if the symbol table (produced on assembly} becomes close 
enough to the source to be in danger of overwriting it, the message 
“Out of symbol space ' 
is issued. Similarly if, when entering text, the source file becomes too 
close to ZEUS the message 
* Out of memory ’ 
is produced. 


If either of these occur the source file must be moved down in 
memory. This can be done using the Monitor ‘COPY’ command. However, 
great care should be exercised to ensure that, if necessary, RAMTOP is 
redefined using the BASIC command CLEAR before copying down. 
APPENDIX FIVE 


Useful Zeus routines 


You may wish to call some of the following ZEUS subroutines from 
your own programs: 


NAME ADDRESS FUNCTION 
INPUTCHAR # F652 Wait for a key to be pressed: result in A 
PRINTCHAR #FSQ3 Print char in A. May also be a control 


character (see below). If printer flag is 
non zero will also output to printer. 


PRINTDECIMAL #ESA3 Write HL in decimal followed by aspace 

PRINTHEXBYTE #F2DF Write A in hex followed by a space 

PRINTHEXWORD #E571 Write HL in hex followed by a space 

PRINTSTRING #E4E3 Write the string following the call; 
string must be terminated by byte zero. 

INPUTLINE #F6E2 Enter screen editor, put line which 
cursor is on in buffer 

BUFFER #FEQQ 32 character buffer terminated by a 
byte zero 

PRINTERFLAG  #F4CB Non-zero to enable printer 

PRINTDECNZ # ESSE Print decimal number in HL without 


leading zeroes 


Notes: 1) All prints send characters to the printer as well as VDU 
if PRINTERFLAG is non-zero 
2) PRINTCHAR also allows the use of screen editing commands. 
For example, printing byte #®F will clear the screen. 


The list of editor control characters is as follows: 


#04 Delete character under cursor 

#905 Insert space at cursor position e: 
#06 Move cursor position to next tab position 
#07 Clear line containing cursor 


#08 Move cursor left 
#99 Move cursor right 


#QA Move cursor down 
#0B Move cursor up 
# OC Move cursor left and blank character under cursor 
#0D Move cursor to beginning of next line 
Scroll if on bottom line 
# OF Clear screen and cursor home 
APPENDIX SIX 


Further machine code facilities from Crystal Computing: 
ZX Spectrum Machine Code Monitor and Disassembler Package. 


This program provides additional facilities to aid the inspection, analysis 
and debugging of your routines; with this and ZEUS co-resident in memory 
your Spectrum becomes a truely comprehensive Z80 programming unit. 


NB. When you intend to use both programs at once, load ZEUS in 
FIRST, then QUIT and load in the 16 K Monitor and Disassembler. You 
may enter both utilities seperately, but it is convenient to enter ZEUS by 


using the Monitor command: 
Goto EQ9@ 


The use of the ZEUS command QUIT will then return control to the 
Monitor and Dissassembler. 


